PR types

New features

PR changes

APIs

Describe

Pcard-67164

本 PR 为 Paddle 新 IR 的属性系统开发，属性系统与类型系统设计方案一致，类型系统开发 PR 见：（1）Type基础数据结构开发、（2）Type类型生成工具开发、（3）IrContext、（4）Dialect 及内置类型开发

1、PR 主要内容

1.1 Attribute 基础数据结构

• attribute_base.h
  • class AbstractAttribute：将所有 Attribute 类共有的属性和行为抽象为一个 AbstractAttribute 类。Attribute 有 2 种：无参 Attribute、有参 Attribute，所有 Attribute 共有的属性就是 TypeId，因此构造一个类，将 TypeId 作为其成员。
  • class AttributeStorage：用于存储一个 Attribute 的所有信息，一个 Attribute 对象包含一个 AttributeStorage。无参类型 Attribute，信息包括：TypeId，因此 AttributeStorage 只需要包含 AbstractAttribute 即可；有参类型 Attribute，除了包含 AbstractAttribute/TypeId 之外，还需要包含参数信息，需要基于此派生出其他的AttributeStorage；
• attribute.h
  • 定义 class Attribute，作为用户使用的唯一接口，是所有内置属性/自定义属性的基类；

1.2 Attribute 构造、注册、管理

• attribute_base.h
  • 定义 AttributeManager 工具类，提供 get/RegisterAttribute 方法，用于向 IrContext 中获取、注册类型；
  • 定义 2个工具宏：DECLARE_ATTRIBUTE_UTILITY_FUNCTOR、REGISTER_ATTRIBUTE_2_IRCONTEXT，用于 Attribute 的定义及注册；

1.3 内置 Attribute

• builtin_attribute.h
  • 当前注册了 StringAttribute 及其对应的 StringAttributeStorage

注：IrContext 及 Dialect 基础数据结构已在类型系统开发完成，本 PR 在 IrContext 及 Dialect 内添加 Attribute 相关接口及数据结构，详见：ir_context.h 及 dialect.h

2、Attribute 用法介绍

2.1 使用内置 Attribute：

// 获取 Attribute 对象
ir::IrContext *ctx = ir::IrContext::Instance();
ir::Attribute string_attr = ir::StringAttribute::get(ctx, "string_a", 8);
// 使用 isa 进行类型判断
std::cout << ir::StringAttribute::classof(string_attr) << std::endl; // 1
// 使用dyn_cast 进行类型转换
ir::StringAttribute string_attr_cast = string_attr.dyn_cast<ir::StringAttribute>();
std::cout << string_attr_cast.isa<ir::StringAttribute>() << std::endl; // 1